Weblogic Server Deployment Map Tool

　　产品介绍

　　在BEA的产品线中，WebLogic Server是最为大家熟知的产品。作为经典的J2EE应用服务器，已经有成千上万的开发者为其开发丰富多彩的应用。在复杂的企业环境中，一个综合性J2EE应用会包括很多不同功能的模块。架构设计者会根据业务需求，对不同模块使用恰当的实现方式，通过应用服务器提供的容器间通信能力，完成复杂的应用场景。当随着应用规模的扩大和业务能力不断增强，不同模块之间的依赖和调用关系成为应用开发/调试过程中伤脑筋的问题。尤其是当需求变更时，希望尽量重用已有模块，则更需要对现有应用架构状况做全面了解。当一个应用包括上百个模块时，用语言或文字描述模块间的关系已经显得捉襟见肘，这时能概览应用全局的工具显得格外重要。

　　BEA的一些开发人员面对这种情况，提供了一个简单的应用呈现工具，名为WebLogic Server Deployment Map Tool，简称Deployment Map。它主要使用图形方式显示一个Domain中应用模块间关系的全貌。虽然在WebLogic Server中提供了Console，能看到每个应用/模块的详细信息，但是当部署了大量应用时仅仅使用Console显然是不够的。因此这个工具只是在模块关系方面对Console做功能方面的补充，使用时需要结合Console和其他工具。Deployment Map包括两部分，一部分是基于脚本的命令行工具，另一部分是有图形界面的Web应用。两者在功能上是相同的，前者是一个一个普通Java客户端程序，而后者要部署到一个WLS Domain上。目前这个工具针对的目标WLS版本是9和10，下面是这个工具的支持环境列表。

　　Deployment Tool 客户端执行环境 目标环境

　　命令行工具 Supported JDK:

　　JDK 1.5.0

　　Tested JDK:

　　Sun 1.5.0_06 - Windows

　　Supported WLS:

　　BEA WebLogic Server 9

　　BEA WebLogic Server 10

　　Tested WLS:

　　WLS 9.2 MP1 - Windows XP

　　WLS 9.2.0 - AIX 5.3

　　Web工具 Supported WLS:

　　BEA WebLogic Server 9

　　BEA WebLogic Server 10

　　Tested WLS:

　　WLS 9.2 MP1 - Windows XP

　　WLS 9.2.0 - AIX 5.3

　　Tested browser:

　　Firefox 2.0 - Windows

　　命令行工具

　　命令行工具使用非常简单。首先使用命令行工具的机器上必须已经装有WebLogic Server 9或以上版本。然后下载本文附带的文件tf7deploy.jar到本地。以9.2为例，准备好环境后写一个如下的的执行脚本：

　　set BEA_HOME=c:\bea921

　　set TF7_JAR=tf7deploy.jar

　　call %BEA_HOME%\weblogic92\server\bin\setWLSEnv.cmd

　　set CLASSPATH=%TF7_JAR%;%CLASSPATH%

　　start "deployment tool"

　　别忘了把前两行修改为符合为本地情况的值。执行该脚本，会启动一个命令行窗口。在开始使用这个工具之前，还需要知道目标Server的位置，以及管理员帐户。使用如下命令可以了解如何使用该工具：

　　java weblogic.ps.DeploymentMap –help

　　观察输出，能看到除了添加访问信息外，还可以对输出结果进行过滤，排序以及替换分隔符等。

　　Usage: weblogic.ps.DeploymentMap -user -pass -url {-app } {-appregex } [-cluster ] [-instance ] [-sort]

　　-help: prints this message

　　-user: user identificator

　　-pass: user password

　　-url: administration URL (i.e. t3://myhost:myport)

　　-verbose: print verbose information (default: off)

　　-debug: print debug information (default: off)

　　-instance: list only applications deployed to instance (default: all running instances) (repeat allowed)

　　-cluster: list only applications deployed to cluster

　　-app: list only applications that start with prefix (repeat allowed)

　　-appregex: list only applications that start with regular expression

　　(Java format - repeat allowed)

　　-sort: sort application list by name (default: unsorted)

　　-separator: set text ouput separator (default: - )

　　比如要获得本地Server的所有应用信息，则使用：

　　java weblogic.ps.DeploymentMap -user weblogic

　　-pass weblogic -url t3://localhost:7001 -sort

　　输出结果里包括了当前部署的所有应用和库，分别用[app]和[lib]表示。如果有依赖关系，则会用缩进表示。

　　[app] - DeploymentMapWeb - DeploymentMapWeb -

　　[app] - TestEAR - TestEAR -

　　[uses] - TestEAR - beehive-controls-1.0#1.0@1.0

　　[uses] - TestEAR - weblogic-controls-1.0#1.0@1.0

　　[uses] - TestEAR - wls-commonslogging-bridge#1.0@1.1

　　[app] - WseeJmsModule - WseeJmsModule -

　　[app] - bea_wls9_async_response - bea_wls9_async_response -

　　[lib] - bea_wls_async_response - bea_wls_async_response -

　　[app] - bea_wls_deployment_internal - bea_wls_deployment_internal -

　　[app] - bea_wls_diagnostics - bea_wls_diagnostics -

　　[app] - bea_wls_internal - bea_wls_internal -

　　[app] - bea_wls_management_internal2 - bea_wls_management_internal2 -

　　[app] - bea_wls_remote_deployer - bea_wls_remote_deployer -

　　[lib] - beehive-controls-1.0-war#1.0@1.0 - beehive-controls-1.0-war - 1@1.0

　　[lib] - beehive-netui-1.0#1.0@1.0 - beehive-netui-1.0 - 1@1.0

　　[lib] - beehive-netui-resources-1.0#1.0@1.0 - beehive-netui-resources-1.0 - 1@1.0

　　[app] - cgDataSource - cgDataSource -

　　[app] - cgDataSource-nonXA - cgDataSource-nonXA -

　　[app] - consoleapp - consoleapp -

　　[lib] - jsf-myfaces#1.1@1.1.1 - jsf-myfaces - 1.1@1.1.1

　　[lib] - jsf-ri#1.1@1.1.1 - jsf-ri - 1.1@1.1.1

　　[lib] - jstl#1.1@1.1.2 - jstl - 1.1@1.1.2

　　[app] - mejb - mejb -

　　[app] - samplesDataSource - samplesDataSource -

　　[lib] - struts-1.1#1.1@1.0 - struts-1.1 - 1.1@1.0

　　[lib] - struts-1.2#1.2@1.2.9 - struts-1.2 - 1.2@1.2.9

　　[lib] - struts-1.2#1.2@1.0 - struts-1.2 - 1.2@1.0

　　[app] - uddi - uddi -

　　[app] - uddiexplorer - uddiexplorer -

　　[lib] - weblogic-controls-1.0-war#1.0@1.0 - weblogic-controls-1.0-war - 1@1.0

　　[lib] - wls-commonslogging-bridge#1.0@1.0 - wls-commonslogging-bridge - 1@1.0

　　[lib] - wls-commonslogging-bridge-war#1.0@1.0 - wls-commonslogging-bridge-war -1@1.0

　　[app] - wlstestclient - wlstestclient -

　　当然，也可以在命令的参数中添加过滤条件等等。虽然这个命令行工具简单方便，但看上去不怎么直观，而且对查询条件的输入也不够友好。来继续试试Web工具。

　　Web工具

　　Web工具是一个War文件，可以部署在WLS9或以上版本的Domain中。事实上为了简化起见，可以把Web工具和目标应用部署到同一个Domain中。下面就用部署在同一个Domain的方式为例来亲身体验一下。

　　下载本文的附件DeploymentMapWeb.war，使用Console或其他工具以应用的方式部署到Domain中，并启动这个应用。部署好后在Console的Deployments中能看到这个应用对应的访问地址是http://localhost:7001/DeploymentMapWeb。用浏览器访问这个地址，能看到对应的Web页面。在该页面的上半部分是访问目标Server的一些属性，比如访问地址和管理员的帐户。此外还有应用名，Cluster名，实例名等过滤条件。如果看当前Server的所有应用，只需要在URL填写t3://localhost:7001，在User和Password填写管理员帐号（默认是weblogic/weblogic）即可。在Format上选择Graph，然后点Render，就会在页面的下半部分显示出系统的应用关系视图。

　　在视图中间是当前Domain，和Domain用线连接的是当前部署的所有应用和库。点其中任何一个，能看到这个应用/库会挪到图的中心，并且和该应用/库关联的模块也会以关联线的形式显示出来。同样，如果在上面Application框中填写应用的名字，则会显示以此应用/库关联的模块。

　　特别注意的是，Application的过滤条件值需要符合Java的Regex语法，比如可以用Test.*表示所有Test开头的模块表示。

　　使用总结

　　虽然这个工具比较简单，但在应用模块繁多的情况下，的确能助我们一臂之力。目前这个工具的版本是1.0，使用JMX和目标系统连接。图形的显示使用的是开源工具hypergraph。受实现方式的限制，目前目标系统只能是WLS的9和10，而且图形只能以关系树的形式展现。希望在未来的版本中能提供对其他J2EE应用服务器的支持，并且能提供更丰富的图形能力。此外如果能在图形上点击模块就可以直接进入Console，那就更方便了。